Working with placeholders
A placeholder is a section of text that is placed in a document, temporarily until the final text is inserted there at a later stage.
In our context, placeholders are there to identify variables (name, email, etc ...) mainly in email templates but sometimes also elsewhere.
In all cases, the available placeholders are always specified when they can be used.
How to use placeholders?
For example, let's say you to start your template with Hello followed by the name of your customer.
Just write as below and leave your cursor one blank space after Hello.
Then click on Customer name, this will automatically insert your placeholder in the right place.
It's as simple as that. All you have to do is save your template.
Custom fields as placeholders
Since version 3.1.7, you can use custom fields as placeholders in your email templates and in Setting > Email notifications.
The principle is simple, you take the id of your custom field (eg id: custom-field1) and paste it to #field_.
#field_custom-field1 will be identified as any other placeholder available in your editor.
Message placeholders
Service name
#service_name The name of the service you want to display.
Category name
#current_category_name Represents the category selected by a customer.
Category names
#category_names Shows all the categories to which service belong.
Customer name
#customer_name The name of your customer.
Booking date
#appointment_day The selected date of the booking.
Booking time
#appointment_time The selected time of the booking.
Booking local date
#appointment_local_date Displays the selected booking date converted to the customer’s time zone.
Booking local time
#appointment_local_time Displays the selected booking time converted to the customer’s time zone.
Appointment ID
#appointment_idDisplays the identification number of the customer’s reservation.
Customer phone
#customer_phone Displays the phone number of your customer.
Customer email
#customer_email Displays the email of your customer.
Customer comment
#customer_comment Displays the comment left from your customer.
Custom data
#customer_custom Displays the custom data you defined using custom fields.
Items count
#items_count
Selected count
#selected_count Displays the count of time slots booked in Multiple mode Displays the number of items/places reserved
.Total amount
#total_amount The total amount to pay for your customer.
Payment link
#payment_link The link to direct your customer to the payment page.
Cancel link
#cancel_link The link to allow your customer the cancellation of his booking.
Agenda for tomorrow
#tomorrow_agenda Displays all the bookings for the next day. Convenient for the administrator or staff.
Group customer name
#group_customer_name List of the customers concerned by the booking.
Create loop
[appointment_loop_start][appointment_loop_end] To use in case you allow multiple booking in one session. Put the date and time in between.
Administrator cancel link
#admin_cancel_link In case you want to cancel your customer booking. To use in administrator email notification. It may be more convenient in some case.
Administrator approval link
#admin_approve_link In case you want to approve manually your customer booking. To use in administrator email notification. It may be more convenient in some case.
Customer Google calendar link
#add_event_link This link will automatically create an event into the Google calendar from your customer.
Booking time range
#time_range In case you want to display in start-end format the time of the booking.
Time range
#timerange
Only available with ‘Multiple bookings in one session’ enabled.
The time range placeholder would contain11:00 am – 3:00 pm if you would have selected the range of time slots from 11:00 am to 3:00 pm.
Time date range
#timedaterange
Only available with ‘Multiple bookings in one session’ enabled.
The time range placeholder would contain May 1, 2019 11:00 am – May 1, 2019 3:00 pm if you would have selected the range of time slots from 11:00 am to 3:00 pm.
Duration
#duration
Displays the time allocated to the reservation.
Subject placeholders
These are the placeholders you can use in your emails subjects.
Service name
#service_name The name of the service you want to display.
Category names
#category_names The name of the category you want to display.
Customer name
#customer_name The name of your customer.
Booking date
#appointment_day The selected date of the booking.
Booking time
#appointment_time The selected time of the booking.
Booking local date
#appointment_local_date Displays the selected booking date converted to the customer’s time zone.
Booking local time
#appointment_local_time Displays the selected booking time converted to the customer’s time zone.
Appointment ID
#appointment_id Displays the identification number of the customer’s reservation.
Customer phone
#customer_phone Displays the phone number of your customer.
Customer email
#customer_email Displays the email of your customer.
Customer comment
#customer_comment Displays the comment left from your customer.
Custom data
#customer_custom Displays the custom data you defined using custom fields.
Items count
#items_count Displays the number of items/places reserved.
Total amount
#total_amount The total amount to pay by your customer.
Group customer name
#group_customer_name List of the customers concerned by the booking.
Create loop
[appointment_loop_start][appointment_loop_end] To use in case you allow multiple booking in one session. Put the date and time in between.
Booking time range
#time_range In case you want to display in start-end format the time of the booking.
Placeholders for price
#subtotal_amountShow the price before tax #tax_amount Show how the amount of is tax in price #one_slot_price Price of one slot #status The status of appointment
Example: For a price of $200 and tax of 10: #subtotal_amount will show $200 and #tax_amount will show $20.